home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / overm82.zip / OLDDOCS.ZIP / OVERM81.DOC next >
Text File  |  1990-01-14  |  8KB  |  250 lines
  1.  
  2.                       OverMail v0.81 Mini-Documentation
  3.                              by Tom Collins
  4.                                 01-13-90
  5.  
  6.      Welp, it's that time again folks... time for a new OverMail set of
  7.      programs.  The latest versions are as follows:
  8.  
  9.      F2RC.EXE       v0.81
  10.      R2FC.EXE       v0.81 (there are no v0.76 - v0.80)
  11.      RENUM310.EXE   v3.10
  12.      PIP.EXE        v1.20
  13.  
  14.      What's New
  15.      ----------
  16.  
  17.      OverMail v0.81 is a MAJOR rewrite of previous versions.  No longer do
  18.      the programs keep the fidonet *.MSGs on disk.  All information is now
  19.      read into the RBBS message bases, and all programs can read a common
  20.      configuration file.  This should save most of you several megs of disk
  21.      space, as well as a lot of hassle creating batch files.  The netmail
  22.      directories should remain on disk, but there will normally be nothing
  23.      in the directories.
  24.  
  25.      NEWIN.EXE and NEWOUT.EXE are obsolete, and can be trashed.  The new
  26.      R2FC and F2RC only run when messages are new.
  27.  
  28.      The manual matrix option has been eliminated, due to lack of interest.
  29.      All programs now run in "quiet" mode, and only write to the screen
  30.      when something major is happening.
  31.  
  32.      The new OverMail will work with RBBS versions 17.2x and above.  If
  33.      you're running v17.1x or below, these programs are not for you, as
  34.      they depend on a RBBS code enhancement in v17.2A.
  35.  
  36.      Upgrading
  37.      ---------
  38.  
  39.      If you're using a previous OverMail, here's what you do:
  40.  
  41.         1.  Join all of your Fidonet conferences and delete any messages
  42.             that are #1.  The old version started numbering at two, and the
  43.             new version will export message #1, if found.  You don't want
  44.             it to...
  45.  
  46.         2.  Make sure that all newly-entered messages have been exported by
  47.             the old version.  Run your mail batch file to do this.
  48.  
  49.         3.  Create a file in your mailer's directory called OVERMAIL.CFG.
  50.             A sample is supplied.  This file contains all of the
  51.             conferences on your system, BOTH fidonet and local.  A good way
  52.             to start is to use your AREAS.BBS file to get the area names
  53.             and directories, and your old mail batch files to get the file
  54.             names and number of messages.
  55.  
  56.             When entering local conferences, leave the path amd number of
  57.             messages fields blank.  For an area name, make something up.
  58.  
  59.             In the options field, you can now put:
  60.  
  61.                  M - Matrix Mail Area - Show Origin
  62.                  D - Delete private messages
  63.                  P - Publicize private messages (default)
  64.                  K - Keep private messages private
  65.  
  66.             Normally, you'd put "MK" (without the quotes) in the options
  67.             field for your matrix mail area, and leave the other areas'
  68.             options blank.
  69.  
  70.             No blank lines are allowed in OVERMAIL.CFG.  You can use a
  71.             semicolon as the first character on a line for a comment.
  72.  
  73.         4.  Check and double-check that OVERMAIL.CFG is correct.  You only
  74.             get one chance to convert from the old to the new version, and
  75.             if something is fouled up, you could end up generating more
  76.             dups than Fidonet has ever seen.
  77.  
  78.         5.  Go to your mailer directory, and run F2RC like this:
  79.  
  80.                F2RC Overmail.Cfg /OLD
  81.  
  82.             This tells F2RC that you're upgrading from an old version.  If
  83.             all is correct, F2RC will report that it removed the messages
  84.             from your RBBS message base and re-imported 'em.  The /OLD
  85.             option is similar to the old version's "from scratch" option.
  86.  
  87.         6.  Check your RBBS-PC configuration.  Make sure that you've told
  88.             RBBS to remove messages starting with "SEEN-BY".
  89.  
  90.         7.  Modify your mail batch files.  In the place where you used to
  91.             run R2FC and NEWOUT, now put:
  92.  
  93.                R2FC Overmail.Cfg
  94.  
  95.             Where F2RC and NEWIN used to be, put:
  96.  
  97.                F2RC Overmail.Cfg
  98.  
  99.             Where RENUM301 used to be, put:
  100.  
  101.                RENUM310 Overmail.Cfg
  102.  
  103.             Remove any places where you used to use PIP to pack any local
  104.             message bases (netmail areas are packed by F2RC, of course),
  105.             and put:
  106.  
  107.                PIP Overmail.Cfg
  108.  
  109.      You should be all set up.
  110.  
  111.      Rescanning
  112.      ----------
  113.  
  114.      Now that F2RC removes any *.MSG after importing, CONFMAIL/QMail can't
  115.      rescan for a new node, should you be forwarding mail to a new person.
  116.      The new programs provide an option to let you regenerate the *.MSGs so
  117.      that CONFMAIL/QMail can generate new packets for new nodes.  Here's
  118.      what you do in your mail batch file:
  119.  
  120.         rem - Rescan Messages -
  121.  
  122.         R2FC Overmail.Cfg /RESCAN
  123.         CONFMAIL export -aAREAS.BBS
  124.         F2RC Overmail.Cfg
  125.  
  126.      One Area
  127.      --------
  128.  
  129.      Each new program has the capability to process a single message area,
  130.      by using the /A command line parameter.  You put /A immedaitely
  131.      followed by the area name.  Here's an example:
  132.  
  133.         RENUM310 Overmail.Cfg /ANET-261
  134.  
  135.      Let's say you just added a node to your C_ECHO list in AREAS.BBS and
  136.      wanted to recan just that area.  You might do this:
  137.  
  138.         R2FC Overmail.Cfg /RESCAN /AC_ECHO
  139.         CONFMAIL export -aAREAS.BBS
  140.         F2RC Overmail.Cfg /AC_ECHO
  141.  
  142.      Other Programs
  143.      --------------
  144.  
  145.      If you run programs that process *.MSGs, you can do this:
  146.  
  147.         R2FC Overmail.Cfg /RESCAN /AC_ECHO
  148.  
  149.         rem - The *.MSGs for C_ECHO are now on disk -
  150.  
  151.         <Process *.MSGs>
  152.  
  153.         rem - Re-import the *.MSGs and delete 'em -
  154.  
  155.         F2RC Overmail.Cfg /AC_ECHO
  156.  
  157.      If you're using a program like msged that creates *.MSG files, you can
  158.      still use it to ENTER messages.  Any *.MSG that F2RC finds in a
  159.      netmail directory will be considered new and imported.  To reply to
  160.      messages, use the rescan procedure above.
  161.  
  162.      How it works
  163.      ------------
  164.  
  165.      When F2RC imports a new *.MSG, it imports the entire message into the
  166.      RBBS message base, and hides the extra information behind a ^A.  RBBS
  167.      v17.2x ignores any line that begins with a ^A.  If asked to re-export
  168.      a message, F2RC can thus recreate the original *.MSG file without
  169.      corrupting it, as programs like RBBSMAIL do.
  170.  
  171.      Errorlevels
  172.      -----------
  173.  
  174.         R2FC exits with an errorlevel of 2 if anything was exported, 1 if
  175.         there was a disk error, or 0 otherwise.
  176.  
  177.         F2RC exits with an errorlevel of 1 for a disk error, or 0
  178.         otherwise.
  179.  
  180.      Batch Files
  181.      -----------
  182.  
  183.      It's recommended that whenever you run R2FC, you also run F2RC.
  184.      Here's a batch file "skeleton" to follow:
  185.  
  186.      cd\mailer
  187.      :Process
  188.  
  189.         R2FC Overmail.cfg
  190.         if errorlevel 2 goto ScanIt
  191.         if errorlevel 1 goto DiskError
  192.         goto ImportPKTs
  193.  
  194.         :ScanIt
  195.  
  196.            rem Export anything that r2fc created.
  197.  
  198.            CONFMAIL export -Aareas.bbs
  199.            oMMM
  200.               - or -
  201.            Qmail scan pack
  202.  
  203.         :ImportPKTs
  204.  
  205.            rem Import any newly received fidonet packets
  206.  
  207.            CONFMAIL import -Aareas.bbs
  208.               - or -
  209.            Qmail toss
  210.  
  211.            rem Export any *.MSGs that just came in (for the next guy in line)
  212.  
  213.            CONFMAIL export -Aareas.bbs
  214.            oMMM
  215.               - or -
  216.            Qmail scan pack
  217.  
  218.            F2RC Overmail.Cfg
  219.  
  220.            if errorlevel 1 goto DiskError
  221.            goto End
  222.  
  223.      :PackRenum
  224.  
  225.         PIP Overmail.Cfg
  226.         RENUM310 Overmail.Cfg
  227.         goto End
  228.  
  229.      :Rescan
  230.  
  231.         R2FC Overmail.Cfg /Rescan
  232.         if errorlevel 1 goto DiskError
  233.  
  234.         CONFMAIL export -Aareas.bbs
  235.         oMMM
  236.            - or -
  237.         Qmail scan pack
  238.  
  239.         F2RC Overmail.Cfg
  240.         if errorlevel 1 goto DiskError
  241.         goto End
  242.  
  243.      Conclusion
  244.      ----------
  245.  
  246.      Good luck!
  247.  
  248.      -- Tom
  249.  
  250.